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WaveNet:  A  Web-Based  Metocean  Data 
Access,  Processing  and  Analysis  Tool, 

Part  2  -  WIS  Database 

by  Zeki  Demirbilek,  Lihwa  Lin,  Derek  Wilson,  and  Jay  Rosati 

PURPOSE:  This  Coastal  and  Hydraulics  Engineering  Technical  Note  (CHETN)  describes 
coupling  of  the  US  Army  Engineer  Research  and  Development  Center  (ERDC)  Wave 
Information  System  (WIS)  database  to  Wavenet,  the  first  module  of  MetOcnDat  (Meteorological 
and  Oceanographic  Data  or  Metocean  data)  management  and  analysis  system.  Part  2  in  the 
WaveNet  technical  note  series  provides  a  step-by-step  procedure  for  users  to  access,  process  and 
analyze  wave  and  wind  data  from  the  WIS  database. 

BACKGROUND:  Wilson  et  al.  (2012)  provided  a  detailed  description  of  WaveNet  in  the  Part  1 
companion  CHETN  and  demonstrated  the  utility  of  WaveNet  for  National  Data  Buoy  Center 
(NDBC)  wave  data.  WaveNet  is  a  web-based  Graphical-User-Interface  (GUI)  data  management 
tool  that  allows  users  to  access,  process  and  analyze  wave  and  wind  data  from  different  metocean 
data  sources.  TideNet  is  the  next  addition  to  the  MetOcnDat  system  that  will  provide  access  and 
similar  functionality  for  water  level  and  current  data.  Once  the  user  identifies  a  data  need  for  a 
time  interval,  WaveNet  performs  data  processing  on-the-fly  to  check  the  availability,  quality  and 
consistency  of  data.  It  allows  users  to  extract  data  to  download,  analyze  and  prepare  input  files 
for  numerical  wave  models,  and  provides  tabular  and  graphical  information  for  project  planning 
and  design  reports.  WaveNet  addresses  a  basic  need  of  the  Corps  coastal  modeling  and  planning 
missions  by  acquiring  metocean  data  and  providing  analysis  methods  to  minimize  the  complexity 
and  uncertainty  involved  in  data  processing.  This  CHETN  provides  a  guide  for  users  to  access 
the  WIS  database  using  WaveNet  and  step-by-step  instructions  that  demonstrate  processing  and 
analysis  of  WIS  data  for  project  planning,  design  and  evaluation  studies,  as  well  as  the 
generation  of  input  files  for  numerical  wave  models. 

For  a  given  geographic  region,  WaveNet  employs  a  Google  Map®  interface  to  query,  select  and 
display  data  from  different  sources.  This  flexible  tool  allows  users  to  choose  a  preferred  data 
source  for  viewing  and  to  select  a  particular  set  of  data  parameters  of  interest.  Selections  are  used 
to  query  the  availability  of  data  and  then  plot,  analyze,  and  extract  data  for  a  specified  date  range 
(selected  timeline).  Post-processing  analyses  are  used  to  produce  tabular  data  and  plots  in  a  desired 
format,  and  write  input  files  for  numerical  models.  WaveNet  allows  users  to  download  data  files 
from  a  data  source  or  access  statistical  wave  parameters  such  as  significant  wave  height,  peak 
period  and  direction  for  a  user-specified  date  range,  and  generate  wave  and  wind  roses  for 
directional  wave  data.  Types  of  WaveNet  outputs  include  image  files  (*.png),  portable  document 
files  (*.pdf),  Matlab  figures  (*.fig),  text  files  (*.csv  or  *.txt),  and  spectral  input  files  (*.eng)  for 
numerical  models.  Users  can  modify  the  figures  to  view  data  plots  and  change  axes,  labels  or  text 
for  project  reports  and  other  publications  as  necessary.  The  *.eng  file  is  an  input  file  in  the  required 
format  that  can  be  used  by  the  numerical  wave  models  such  as  Coastal  Modeling  System  Wave 
model  (CMS-Wave)  (Demirbilek  and  Rosati  2011;  Lin  et  al.  2011a,  b;  Lin  et  al.  2008)  and  STeady 
WAVE  model  (STWAVE)  (Massey  et  al.  201 1). 

Approved  for  public  release;  distribution  is  unlimited. 


US  Army  Corps 
of  Engineers® 


Report  Documentation  Page 

Form  Approved 

OMB  No.  0704-0188 

Public  reporting  burden  for  the  collection  of  information  is  estimated  to  average  1  hour  per  response,  including  the  time  for  reviewing  instructions,  searching  existing  data  sources,  gathering  and 
maintaining  the  data  needed,  and  completing  and  reviewing  the  collection  of  information.  Send  comments  regarding  this  burden  estimate  or  any  other  aspect  of  this  collection  of  information, 
including  suggestions  for  reducing  this  burden,  to  Washington  Headquarters  Services,  Directorate  for  Information  Operations  and  Reports,  1215  Jefferson  Davis  Highway,  Suite  1204,  Arlington 

VA  22202-4302.  Respondents  should  be  aware  that  notwithstanding  any  other  provision  of  law,  no  person  shall  be  subject  to  a  penalty  for  failing  to  comply  with  a  collection  of  information  if  it 
does  not  display  a  currently  valid  OMB  control  number. 

1.  REPORT  DATE 

AUG  2013  2.  REPORT  TYPE 

3.  DATES  COVERED 

00-00-2013  to  00-00-2013 

4.  TITLE  AND  SUBTITLE 

WaveNet:  A  Web-Based  Metocean  Data  Access,  Processing  and  Analysis 
Tool,  Part  2  -  WIS  Database 

5a.  CONTRACT  NUMBER 

5b.  GRANT  NUMBER 

5c.  PROGRAM  ELEMENT  NUMBER 

6.  AUTHOR(S) 

5d.  PROJECT  NUMBER 

5e.  TASK  NUMBER 

5f.  WORK  UNIT  NUMBER 

7.  PERFORMING  ORGANIZATION  NAME(S)  AND  ADDRESS(ES) 

US  Army  Engineer  Research  and  Development  Center, Vicksburg, MS, 
39180 

8.  PERFORMING  ORGANIZATION 

REPORT  NUMBER 

9.  SPONSORING/MONITORING  AGENCY  NAME(S)  AND  ADDRESS (ES) 

10.  SPONSOR/MONITOR’S  ACRONYM(S) 

11.  SPONSOR/MONITOR’S  REPORT 
NUMBER(S) 

12.  DISTRIBUTION/AVAILABILITY  STATEMENT 

Approved  for  public  release;  distribution  unlimited 

13.  SUPPLEMENTARY  NOTES 

14.  ABSTRACT 

15.  SUBJECT  TERMS 

16.  SECURITY  CLASSIFICATION  OF:  17.  LIMITATION  OF 

ARSTRATT 

1 8 .  NUMBER  1 9a.  NAME  OF 

OF  PAGES  RESPONSIBLE  PERSON 

a.  REPORT  b.  ABSTRACT  c.  THIS  PAGE  Same  aS 

unclassified  unclassified  unclassified  Report  (SAR) 

11 

Standard  Form  298  (Rev.  8-98) 

Prescribed  by  ANSI  Std  Z39-18 


ERDC/CHL  CHETN-IV-92 
August  2013 

The  following  example  illustrates  the  use  of  WaveNet  with  WIS  data.  This  is  done  in  a  step-by- 
step  manner  and  includes  comments  and  instructions  to  guide  users,  where  necessary. 

EXAMPLE:  WIS  Data  for  Eastern  Shore  of  Alabama  Project.  For  this  project,  the 
following  wave  and  wind  data  are  needed:  monthly  mean  values  of  significant  wave  height,  peak 
or  mean  wave  period  and  mean  direction  in  tabular  form;  wave  and  wind  roses  for  a  year;  and  the 
*.eng  file  for  1  June  through  1  October  2010  at  a  6-hr  interval.  This  example  shows  how  to  use 
WaveNet  to  access  the  WIS  database,  fetch  the  data  from  the  source  and  provide  data  in  the 
required  format  in  files  for  project  documents  and  use  in  a  numerical  wave  model. 

Step  1 .  Select  the  sub-region  of  interest.  Click  the  following  link  on  an  ACE-IT  machine  to 
start  the  WaveNet  server  (http: //1 40J94JJ_ 0. 95/GoodeMap3/default/Datamap).  Use  the  mouse  to 
click  and  zoom  into  the  region  of  interest  where  data  are  desired  (see  Figure  1).  The  user  can  zoom 
into  any  part  of  the  map  displayed  in  Figure  1,  including  Alaska  and  Hawaii. 


Step  2.  Select  the  data  source  and  type  of  metocean  data  available  from  the  WIS 
database.  The  list  of  available  data  sources  is  shown  in  the  right  side  of  Figures  1  and  2,  and 
include  the  National  Data  Buoy  Center  (NDBC),  Wave  Information  Study  (WIS),  Coastal  Data 
Information  Program  (CDIP),  Wave  Watch  III  (WW3),  and  Field  Research  Facility  (FRF).  Select 
WIS  as  the  data  source.  In  this  example,  the  area  of  interest  is  the  Eastern  Alabama  Gulf  Coast. 
Select  this  area  of  interest  by  using  the  map  tools  and  zooming  in  to  this  region. 
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Figure  2.  WIS  stations  offshore  of  Alabama  and  Mississippi,  and  portions  of  Florida  and  Louisiana. 


Step  3.  Select  the  WIS  station  in  the  area  of  interest.  To  access  the  station-specific  data 
available  from  the  WIS  database,  the  user  can  select  a  WIS  station  from  those  displayed  in 
Figure  2.  For  this  example,  select  Station  73157.  Click  on  the  “View  Station  Home”  link  to  access 
the  station’s  page  on  the  WIS  webpage  or  the  “Access  Station  73157  Data”  window  option  to 
access  the  station’s  data  within  WaveNet.  The  type  of  station-specific  data  available  at  WIS  Station 
73157  is  shown  in  Figure  3.  The  user  can  click  on  any  of  these  data  types  to  view  data  or  the  plots 
and  tables  provided  by  the  WIS  data  source  (see  Figure  3  for  available  information). 


Products  for  Gulf  of  Mexico  Station  73157  Lat3o.os  Lon  -87.92  Depth  13  m  (msl) 
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Figure  3.  WIS  station  page  for  731 57  off  the  Eastern  Shore  of 
Alabama. 
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Step  4.  Set  the  time  range  to  determine  availability  of  data  for  project  needs.  Users 
can  access  the  data  types  at  Station  73157  with  WaveNet  by  specifying  a  time  window  of  interest 
and  clicking  “Retrieve/Plot  Data”  located  at  the  top  section  of  Figure  4.  This  figure  shows  the 
process  of  selecting  a  time  window.  There  is  a  “slider  bar”  at  the  bottom  of  Figure  4  for  changing 
the  start  and  end  times,  or  users  can  manually  type  in  the  desired  dates.  To  narrow  the  time  window 
of  interest  to  specific  days  or  months,  use  the  slider  bar  at  the  bottom  of  the  plot  or  click  on  the 
display  box.  Two  options  are  available  to  change  dates;  type  in  the  Start  and  End  date  boxes,  or  use 
the  calendar  (Figure  4).  Double  click  within  the  Start  and  End  time  boxes  to  get  the  calendar.  The 
timeline  plot  will  show  data  availability  for  wave  height  and  wind  speed  including  the  data  gaps. 
For  a  treatment  of  the  data  gaps,  consult  the  methods  discussed  in  CHETN-IV-83  (Wilson  et  al. 
2012). 


Data  on  73157  available  for  [1980,  1981,  1982,  1983,  1984.  1985,  1986,  1987,  1988.  1989,  1990,  1991,  1992, 1993,  1994.  1995,  1996,  1997.  1998. 
1999] 
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Figure  4.  The  user  can  set  the  time  window  by  using  a  calendar. 


To  preview  or  download  the  selected  station  data,  users  may  plot  wind  or  wave  data  parameters 
either  using  the  WIS  website  data  management  tools  or  WaveNet’s  tools.  In  Figure  4,  time  series 
of  the  significant  wave  height  (blue)  and  wind  speed  (red)  at  WIS  Station  73157  are  displayed 
for  a  user-specified  time  period  (1  Jan  1990  through  31  Dec  1990).  This  display  uses  the 
WaveNet  tools,  while  WIS  and  other  data  sources  may  have  their  own  data  management  tools, 
which  users  could  also  use  to  handle  and  perform  data  operations  prior  to  downloading  and 
processing  data  in  the  WaveNet.  Although  users  have  these  data  access  options,  WaveNet 
provides  a  unified  platform  to  perform  these  functions  in  a  consistent  manner  to  avoid  potential 
errors  and  has  additional  custom  analysis  tools  that  may  not  be  available  from  the  data  sources. 
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Step  5.  Download  data  for  project  needs.  To  perform  additional  analyses  of  data  on  the 
user’s  desktop  machine,  it  is  necessary  for  the  users  to  download  data  from  the  WIS  data  source  for 
the  date  range  chosen.  This  is  done  by  clicking  on  “Download”  to  save  data  in  a  *.csv”  file  as 
shown  in  Table  1.  The  comma-separated  values  (*.csv)  is  an  ASCII  spreadsheet  in  text  format. 
Table  1  displays  the  partially  tabulated  *.csv  data  saved  by  WaveNet.  These  ASCII  data  can  be 
used  with  the  Matlab,  Fortran,  Excel  or  other  software  or  commercial  plotting  packages,  if  desired. 


Table  1.  Tabulated  data  downloaded  to  local 
machine  for  WIS  Station  73157. 
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Step  6.  Wave,  wind  roses,  and  histograms.  These  processing  tools  are  available  in 
WaveNet.  As  noted  in  Step  5,  if  the  data  source  does  not  provide  rose  plots  or  histograms,  users 
can  generate  such  plots  for  wave  or  wind  for  the  segment  of  downloaded  data  by  clicking  on 
“Rose  Plot/Histogram”  below  the  timeline  plot  (as  shown  in  Figure  4).  Rose  plots  can  be 
generated  for  directional  wave  and  wind  data  (shown  in  Figure  5  and  6,  respectively).  The 
percent  occurrence  is  depicted  by  radial  circles,  and  1-m  wave  height  and  4-m/s  wind  speed 
bands  are  color  coded  in  the  radial  direction.  In  both  plots,  the  direction  bins  from  which  waves 
approach  the  shore  are  also  shown.  Figures  5  and  6  show  the  wave  and  wind  histograms  which 
illustrate  the  statistical  distribution  of  wave  height  and  wind  speed. 
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Figure  5.  Rose  plot  and  histogram  for  waves  at  WIS  Station  73157. 
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Figure  6.  Rose  plot  and  histogram  for  wind  at  WIS  Station  73157. 
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Step  7.  Desktop  data  analyses.  After  the  segments  of  data  have  been  accessed  from  the  WIS 
database  and  reviewed  and  downloaded  to  the  user’s  local  machine  using  WaveNet,  users  can  then 
perform  certain  data  analyses.  For  example,  the  CMS-Wave  and  STWAVE  models  require  an 
*.eng  file  for  directional  wave  input.  If  directional  wave  data  (1-D  or  2-D  wave  spectra  and 
associated  Fourier  coefficients  used  to  generate  wave  spectra)  are  available  from  the  data  source 
sites,  users  can  download  these  files  to  their  local  machine  and  perform  post-processing  analyses 
for  their  project  needs.  If  Fourier  coefficients  are  not  provided  by  the  data  sources,  the  user  may 
perform  these  operations  using  WaveNet.  Click  on  “eng  Input  Files”  located  below  the  timeline 
plot  in  Figure  7.  At  the  bottom  of  Figure  7,  *.eng  files  are  listed  according  to  the  timeline  selected 
by  the  user.  Table  2  displays  the  partial  content  of  a  *.eng  file  for  illustration.  See  Lin  et  al.  (201  la, 
2008)  and  Demirbilek  and  Rosati  (201 1)  for  additional  information  about  *.eng  files. 


Data  on  731S7  available  for  [1930,  1981,  1982,  1983,  1984,  1935,  1986,  1987,  1938,  1989,  1990.  1991,  1992,  1993,  1994,  1995,  1996,  1997,  1998, 
1999] 
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Figure  7.  List  of  *.eng  input  files  generated  by  WaveNet  for  WIS  Station  73157. 
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Table  2.  Partial  content  of  an  *.eng  wave  input  file  generated  by  WaveNet. 
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CONCLUSIONS:  This  CHETN  describes  the  application  of  WaveNet  to  the  WIS  database.  An 
example  is  provided  with  a  step-by-step  procedure  that  demonstrates  how  to  use  WaveNet  to 
access  wind  and  wave  data  from  the  WIS  data  source  website.  Steps  illustrate  how  to  extract  and 
analyze  WIS  data  for  use  in  coastal  navigation  and  storm  damage  reduction  projects.  This  is  a 
user-guide  for  engineers  and  planners  to  obtain  wave  and  wind  data  for  project  planning,  design 
and  evaluation  study  reports,  and  develop  input  files  required  for  numerical  wave  models.  WIS 
data  vary  in  content,  complexity  and  accuracy  of  information.  It  was  shown  in  CHETN-IY-83 
(Wilson  et  al.  2012)  how  WaveNet  tools  allow  users  to  identify  data  gaps,  fill  in  missing  data, 
and  provide  users  a  number  of  options  for  handling  data  gaps.  Presently  the  options  include 
interpolation  between  the  endpoints  of  a  gap  in  the  wind  and  wave  data  time  series,  fetching 
missing  data  from  the  nearest  WIS  Station,  and  other  analysis  capabilities.  The  goal  is  to  enhance 
the  capabilities  of  WaveNet  to  help  Districts  obtain  project-specific  data  from  the  WIS  or  other 
data  sources.  User  feedback  is  welcome  for  expanding  and  improving  the  capabilities  of 
WaveNet  to  better  serve  the  US  ACE  community. 

POINTS  OF  CONTACT:  This  CHETN  was  prepared  by  the  Coastal  Inlets  Research  Program 
(CIRP)  Waves  work  unit.  The  POC  for  technical  inquiries  is  Dr.  Zeki  Demirbilek 
(Zeki. Dem irbilekfcuusace. army.mil).  For  information  about  CIRP,  please  contact  the  CIRP  Program 
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Manager,  Dr.  Julie  Dean  Rosati  ( Julie.D.Rosati&Msace . army. mil;  tel:  202-761-1850).  This 

technical  note  should  be  referenced  as  follows: 

Demirbilek,  Z.,  L.  Lin,  D.  Wilson,  and  J.  Rosati.  2013.  WaveNet:  A  web-based 
metocean  data  access,  processing  and  analysis  tool,  part  2  —  WIS  database. 
ERDC/CHL  CHETN-IV-92.  Vicksburg,  MS:  US  Army  Engineer  Research  and 
Development  Center.  An  electronic  copy  of  this  CHETN  is  available  from 

http: //chi,  erdc.  usace.  army.mil/chetn. 
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